SaferPluginHelpers

La classe SaferPluginHelpers fournit diverses méthodes d'aide pour le plugin Safer.

Méthodes

import(string $path, bool $import_again = false, bool $no_cache = false): mixed

public static function import(string $path, bool $import_again = false, bool $no_cache = false): mixed

Description

Importe un fichier PHP et retourne le résultat.

Paramètres

  • string $path : Le chemin du fichier PHP à importer.
  • bool $import_again : Si true, le fichier sera importé à nouveau même s'il a déjà été importé (par défaut : false).
  • bool $no_cache : Si true, le fichier ne sera pas mis en cache (par défaut : false).

Retour

  • mixed : Le résultat de l'importation.

Exceptions

  • Exception : Si le fichier n'existe pas.

Exemple

$result = SaferPluginHelpers::import('/path/to/file.php');

relativeDifference(float $a, float $b): string

public static function relativeDifference(float $a, float $b): string

Description

Calcule la différence relative entre deux nombres flottants.

Paramètres

  • float $a : Le premier nombre.
  • float $b : Le deuxième nombre.

Retour

  • string : La différence relative sous forme de pourcentage.

Exemple

$difference = SaferPluginHelpers::relativeDifference(120, 100); // '20.0'

exec(string $command, bool $async)

public static function exec(string $command, bool $async)

Description

Exécute une commande soit de manière synchrone, soit de manière asynchrone.

Paramètres

  • string $command : La commande à exécuter.
  • bool $async : Si true, la commande est exécutée de manière asynchrone ; sinon, elle est exécutée de manière synchrone.

Exemple

SaferPluginHelpers::exec('php script.php', true); // Exécution asynchrone
SaferPluginHelpers::exec('php script.php', false); // Exécution synchrone

endRequest(mixed $content)

public static function endRequest(mixed $content)

Description

Termine la requête en cours et envoie le contenu spécifié.

Paramètres

  • mixed $content : Le contenu à envoyer. Peut être une fonction callable, une chaîne de caractères, ou un tableau de callables et de chaînes de caractères.

Exemple

SaferPluginHelpers::endRequest('Hello, world!');
SaferPluginHelpers::endRequest(function() { echo 'Goodbye, world!'; });
SaferPluginHelpers::endRequest(['First part', function() { echo 'Second part'; }]);

gettype(mixed $e): string

public static function gettype(mixed $e): string

Description

Obtient le type d'une valeur.

Paramètres

  • mixed $e : La valeur dont on veut connaître le type.

Retour

  • string : Le type de la valeur (par exemple, 'array', 'string', 'callable', etc.).

Exemple

$type = SaferPluginHelpers::gettype(123); // 'numeric'
$type = SaferPluginHelpers::gettype('test'); // 'string'

is_stringable(mixed $e): bool

public static function is_stringable(mixed $e): bool

Description

Vérifie si une valeur peut être convertie en chaîne de caractères.

Paramètres

  • mixed $e : La valeur à vérifier.

Retour

  • bool : true si la valeur peut être convertie en chaîne, false sinon.

Exemple

$isStringable = SaferPluginHelpers::is_stringable(123); // true
$isStringable = SaferPluginHelpers::is_stringable(new stdClass()); // false

bind(callable $callback, ...$args): callable

public static function bind(callable $callback, ...$args): callable

Description

Lie une fonction callable avec des arguments.

Paramètres

  • callable $callback : La fonction ou méthode à lier.
  • mixed ...$args : Les arguments à passer à la fonction ou méthode.

Retour

  • callable : La fonction ou méthode liée.

Exemple

$boundFunction = SaferPluginHelpers::bind('strlen', 'test');
echo $boundFunction(); // 4

Remarques

  • La méthode import utilise un cache pour éviter les imports répétés, à moins que no_cache soit true.
  • La méthode endRequest termine la requête HTTP en cours et envoie le contenu spécifié tout en fermant proprement la connexion.
  • Les méthodes gettype et is_stringable aident à déterminer le type et la stringabilité des valeurs respectivement.